home *** CD-ROM | disk | FTP | other *** search
/ PsL Monthly 1994 January / PSL Monthly Shareware CD-ROM (Public Software Library) (January 1994).iso / games / dos / misc / adulate.com / ADULATE.DOC < prev    next >
Encoding:
Text File  |  1990-08-23  |  6.0 KB  |  149 lines
  1.     ADULATE.EXE - the program that panders to your ego!
  2.  
  3.     Author .... : Larry T Cobb
  4.  
  5.     Created ... : 13:48 Fri 10 Mar 1989
  6.     Last Update : 5/24/89 at 14:35:00
  7.     Release ... : 1.8
  8.  
  9.  
  10.     Executive Summary
  11.  
  12.     In this rat-race of a world it good to have someone (or even something)
  13.     that you can rely on for a bit of obsequious grovelling.  So, if you
  14.     haven't got any sycophantic minions, you can use this program to force
  15.     your poor, unsuspecting PC to bolster your ego.  Call it from your
  16.     AUTOEXEC.BAT for a cringing start to the day's computing, or type
  17.     "ADULATE 20" for a boost during a really bad session.  You'll soon be
  18.     on top of the world again!
  19.  
  20.  
  21.     Using the Random Adulation Program:
  22.  
  23.     Words from four lists of adulating words or phrases are combined
  24.     randomly to form a composite adulation.  The C standard random number
  25.     generator is used to select from the lists.  It is seeded differently
  26.     each run using the system time, so each run will produce an
  27.     unpredictable phrase or set of phrases.
  28.  
  29.  
  30.     Usage:      ADULATE [-n or /n] [count]
  31.  
  32.         If the option '-n' or '/n' is present, the phrase begins with the
  33.         word "o" (lower case) and is not terminated with a newline.
  34.  
  35.         Otherwise it begins with upper case "O" and is terminated with a
  36.         full stop and newline.  (These are the defaults where no '.fmt'
  37.         file is in use - see below.)
  38.  
  39.     The count value is a decimal number of phrases to be produced.  A
  40.     default count of 1 is used if the count parameter is not present or
  41.     evaluates to zero or a negative number.
  42.  
  43.     Arbitrary formats can be specified at run time by including them in a
  44.     text file having the name 'adulate.fmt'.  To be used, this must be in
  45.     the current default directory.  Each line of the file represents an
  46.     alternative format for the output phrases.  These are read into two
  47.     lists in memory, one for formats for use in normal mode, and one for
  48.     formats for the '-n' or '/n' option. If these lists have more than one
  49.     entry, a format for each adulation is selected at random from the
  50.     appropriate list.
  51.  
  52.     If the format file contains no entries for a particular list, the
  53.     default format for that mode is used.  Otherwise the default formats
  54.     are discarded when a format file is in use.
  55.  
  56.  
  57.     The format of each line is:
  58.  
  59.     <format_mode><format_string>
  60.  
  61.     where  <format_mode> is the single character 'F' or 'f', signifying
  62.     that the format specification is to be used in normal mode or with the
  63.     'n' option respectively.  If <format_mode> is omitted, it is taken to
  64.     be 'F'.
  65.  
  66.     <format_string> is the wanted format specified as for 'printf'.  The
  67.     special character specifications '\n', '\t', '\b', '\r','\f' and '\\'
  68.     are recognised, (standard C notation).  Single and double quote
  69.     characters may be included without being escaped since they are not
  70.     used to delimit the format string.
  71.  
  72.     Note:
  73.  
  74.         1) The format string should contain exactly one '%s' specification
  75.            for each of the component word lists, or else operation is
  76.            undefined. No other field specifiers should be included.
  77.  
  78.         2) If the <format_mode> letter is omitted, the <format_string>
  79.            should not begin with 'F' or 'f' or else the first letter of the
  80.            string will be taken to be the <format_mode> and stripped from
  81.            the <format_string>.
  82.  
  83.         3) If the format file is created using a word processor, make sure
  84.            that no formatting characters are left in the file.
  85.  
  86.  
  87.     Examples:
  88.  
  89.         Format: FWhat is your desire, %s %s of the %s %s?\n
  90.         Phrase: What is your desire, unique wonder of the snappy retort?
  91.  
  92.         Format: Hail, %s %s of the %s %s!\n
  93.         Phrase: Hail, leafy keeper of the mighty East!
  94.  
  95.         Format: fsalutations, %s %s of the %s %s
  96.         Phrase: salutations, valiant leader of the unfamiliar palindrome
  97.                 [N.B. this last phrase would have no terminating newline]
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.     Copyright Larry T Cobb, 1989
  105.     CompuServe id: 100016,421
  106.  
  107.  
  108.     You are free to copy and distribute this program provided that no
  109.     charge, of any kind, is made for it, the disk, or distribution.  Also,
  110.     this file must be included with the program and the whole must be
  111.     distributed unaltered.  Any other arrangement requires the author's
  112.     written permission.
  113.  
  114.  
  115.          ----------------end-of-author's-documentation---------------
  116.  
  117.                         Software Library Information:
  118.  
  119.                    This disk copy provided as a service of
  120.  
  121.                         The Public (Software) Library
  122.  
  123.          We are not the authors of this program, nor are we associated
  124.          with the author in any way other than as a distributor of the
  125.          program in accordance with the author's terms of distribution.
  126.  
  127.          Please direct shareware payments and specific questions about
  128.          this program to the author of the program, whose name appears
  129.          elsewhere in  this documentation. If you have trouble getting
  130.          in touch with the author,  we will do whatever we can to help
  131.          you with your questions. All programs have been tested and do
  132.          run.  To report problems,  please use the form that is in the
  133.          file PROBLEM.DOC on many of our disks or in other written for-
  134.          mat with screen printouts, if possible.  The P(s)L cannot de-
  135.          bug programs over the telephone.
  136.  
  137.          Disks in the P(s)L are updated monthly, so if you did not get
  138.          this disk  directly from the P(s)L,  you should be aware that
  139.          the files in this set may no  longer be the current versions.
  140.  
  141.          For a copy of the latest monthly software library newsletter
  142.          and a list of the 2,000+ disks in the library, call or write
  143.  
  144.                         The Public (Software) Library
  145.                               P.O.Box 35705
  146.                            Houston, TX 77235-5705
  147.                                (713) 524-6394
  148.  
  149.